In This Topic ▼

AppendFrames(RasterCodecs,string,List<CompositeJpxImages>,int,int) Method

Summary

Appends new frames to a currently existing JPEG 2000 file. This method is available in the Document/Medical Toolkits.

Syntax

C++

public void AppendFrames( 
   RasterCodecs codecs, 
   string fileName, 
   List<CompositeJpxImages> compositeImages, 
   int bitsPerPixel, 
   int qualityFactor 
)

  
Public Overloads Sub AppendFrames( _ 
   ByVal codecs As RasterCodecs, _ 
   ByVal fileName As String, _ 
   ByVal compositeImages As List(Of CompositeJpxImages), _ 
   ByVal bitsPerPixel As Integer, _ 
   ByVal qualityFactor As Integer _ 
)

public: 
void AppendFrames(  
   RasterCodecs^ codecs, 
   String^ fileName, 
   List<CompositeJpxImages^>^ compositeImages, 
   int bitsPerPixel, 
   int qualityFactor 
)

Parameters

codecs
The Leadtools.Codecs.RasterCodecs object.

fileName
System.String containing the name of the file to which the new frames are being appended.

compositeImages
List of CompositeJpxImages containing the layer image data that will be appended.

bitsPerPixel
Resulting file's pixel depth. Possible values are: 8, 12, 16, 24, 32, 48, 64, and 0. A value of zero [0] means that each image will be saved with its bits per pixel value, if that value is equal to one of the possible values (8, 12, 16, 24, 32, 48, or 64).

qualityFactor
Quality factor. This value determines the degree of loss in the compression process. Possible values are from 0 to 255. A value of zero (0) represents lossless compression. Values between 1 and 255 are interpreted as a compression ratio.

Remarks

All engine boxes will be reset.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Jpeg2000; 
 
public void AppendFramesStringExample(String fileName, List<CompositeJpxImages> images) 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
   Jpeg2000Engine engine = new Jpeg2000Engine(); 
   engine.AppendFrames(codecs, fileName, images, 0, 5); 
   // Clean up 
   codecs.Dispose(); 
}

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.Jpeg2000 
 
Private Sub AppendFramesStringExample(ByVal fileName As String, ByVal images As List(Of CompositeJpxImages)) 
   Dim codecs As New RasterCodecs() 
   codecs.ThrowExceptionsOnInvalidImages = True 
   Dim engine As New Jpeg2000Engine() 
   engine.AppendFrames(codecs, fileName, images, 0, 5) 
 
   '  Clean up 
   codecs.Dispose() 
End Sub